<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="utf-8">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <title>Module::Load::Conditional - Looking up module information / loading at runtime - Perldoc Browser</title>
    <link rel="search" href="https://perldoc.perl.org/opensearch.xml" type="application/opensearchdescription+xml" title="Perldoc Browser">
    <link rel="canonical" href="https://perldoc.perl.org/Module::Load::Conditional">
    <link rel="stylesheet" href="https://stackpath.bootstrapcdn.com/bootstrap/4.5.2/css/bootstrap.min.css" integrity="sha384-JcKb8q3iqJ61gNV9KGb8thSsNjpSL0n8PARn9HuZOnIxN0hoP+VmmDGMN5t9UJ0Z" crossorigin="anonymous">
    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/stackoverflow-light.min.css" integrity="sha512-cG1IdFxqipi3gqLmksLtuk13C+hBa57a6zpWxMeoY3Q9O6ooFxq50DayCdm0QrDgZjMUn23z/0PMZlgft7Yp5Q==" crossorigin="anonymous" />
    <style>
      body {
        background: #f4f4f5;
        color: #020202;
      }
      .navbar-dark {
        background-image: -webkit-linear-gradient(top, #005f85 0, #002e49 100%);
        background-image: -o-linear-gradient(top, #005f85 0, #002e49 100%);
        background-image: linear-gradient(to bottom, #005f85 0, #002e49 100%);
        filter: progid:DXImageTransform.Microsoft.gradient(startColorstr='#ff005f85', endColorstr='#ff002e49', GradientType=0);
        background-repeat: repeat-x;
      }
      .navbar-dark .navbar-nav .nav-link,
      .navbar-dark .navbar-nav .nav-link:focus { color: #fff }
      .navbar-dark .navbar-nav .nav-link:hover { color: #ffef68 }
      #wrapperlicious {
        margin: 0 auto;
        font: 0.9em 'Helvetica Neue', Helvetica, sans-serif;
        font-weight: normal;
        line-height: 1.5em;
        margin: 0;
        padding: 0;
      }
      #wrapperlicious h1 { font-size: 1.5em }
      #wrapperlicious h2 { font-size: 1.3em }
      #wrapperlicious h3 { font-size: 1.1em }
      #wrapperlicious h4 { font-size: 0.9em }
      #wrapperlicious h1, #wrapperlicious h2, #wrapperlicious h3,
      #wrapperlicious h4, #wrapperlicious dt {
        color: #020202;
        margin-top: 1em;
        margin-bottom: 1em;
        position: relative;
        font-weight: bold;
      }
      #wrapperlicious a { color: inherit; text-decoration: underline }
      #wrapperlicious #toc { text-decoration: none }
      #wrapperlicious a:hover { color: #2a2a2a }
      #wrapperlicious a img { border: 0 }
      #wrapperlicious :not(pre) > code {
        color: inherit;
        background-color: rgba(0, 0, 0, 0.04);
        border-radius: 3px;
        font: 0.9em Consolas, Menlo, Monaco, monospace;
        padding: 0.3em;
      }
      #wrapperlicious dd {
        margin: 0;
        margin-left: 2em;
      }
      #wrapperlicious dt {
        color: #2a2a2a;
        font-weight: bold;
        margin-left: 0.9em;
      }
      #wrapperlicious p {
        margin-bottom: 1em;
        margin-top: 1em;
      }
      #wrapperlicious li > p {
        margin-bottom: 0;
        margin-top: 0;
      }
      #wrapperlicious pre {
        border: 1px solid #c1c1c1;
        border-radius: 3px;
        font: 100% Consolas, Menlo, Monaco, monospace;
        margin-bottom: 1em;
        margin-top: 1em;
      }
      #wrapperlicious pre > code {
        display: block;
        background-color: #f6f6f6;
        font: 0.9em Consolas, Menlo, Monaco, monospace;
        line-height: 1.5em;
        text-align: left;
        white-space: pre;
        padding: 1em;
      }
      #wrapperlicious dl, #wrapperlicious ol, #wrapperlicious ul {
        margin-bottom: 1em;
        margin-top: 1em;
      }
      #wrapperlicious ul {
        list-style-type: square;
      }
      #wrapperlicious ul ul {
        margin-bottom: 0px;
        margin-top: 0px;
      }
      #footer {
        font-size: 0.8em;
        padding-top: 0.5em;
        text-align: center;
      }
      #more {
        display: inline;
        font-size: 0.8em;
      }
      #perldocdiv {
        background-color: #fff;
        border: 1px solid #c1c1c1;
        border-bottom-left-radius: 5px;
        border-bottom-right-radius: 5px;
        margin-left: auto;
        margin-right: auto;
        padding: 3em;
        padding-top: 1em;
        max-width: 960px;
      }
      #moduleversion { float: right }
      #wrapperlicious .leading-notice {
        font-style: italic;
        padding-left: 1em;
        margin-top: 1em;
        margin-bottom: 1em;
      }
      #wrapperlicious .permalink {
        display: none;
        left: -0.75em;
        position: absolute;
        padding-right: 0.25em;
        text-decoration: none;
      }
      #wrapperlicious h1:hover .permalink, #wrapperlicious h2:hover .permalink,
      #wrapperlicious h3:hover .permalink, #wrapperlicious h4:hover .permalink,
      #wrapperlicious dt:hover .permalink {
        display: block;
      }
    </style>
    <!-- Global site tag (gtag.js) - Google Analytics -->
    <script async src="https://www.googletagmanager.com/gtag/js?id=G-KVNWBNT5FB"></script>
    <script>
      window.dataLayer = window.dataLayer || [];
      function gtag(){dataLayer.push(arguments);}
      gtag('js', new Date());

      gtag('config', 'G-KVNWBNT5FB');
      gtag('config', 'UA-50555-3');
    </script>
  </head>
  <body>
    <nav class="navbar navbar-expand-md navbar-dark bg-dark justify-content-between">
  <button class="navbar-toggler" type="button" data-toggle="collapse" data-target="#navbarNav" aria-controls="navbarNav" aria-expanded="false" aria-label="Toggle navigation">
    <span class="navbar-toggler-icon"></span>
  </button>
  <a class="navbar-brand" href="https://perldoc.perl.org/">Perldoc Browser</a>
  <div class="collapse navbar-collapse" id="navbarNav">
    <ul class="navbar-nav mr-auto">
      <li class="nav-item dropdown text-nowrap">
        <a class="nav-link dropdown-toggle" href="./Module::Load::Conditional.html#" id="dropdownlink-stable" role="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">5.35.0</a>
        <div class="dropdown-menu" aria-labelledby="dropdownlink-stable">
          <a class="dropdown-item" href="https://perldoc.perl.org/Module::Load::Conditional">Latest</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.38.2/Module::Load::Conditional">5.38.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.38.1/Module::Load::Conditional">5.38.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.38.0/Module::Load::Conditional">5.38.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.36.3/Module::Load::Conditional">5.36.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.36.2/Module::Load::Conditional">5.36.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.36.1/Module::Load::Conditional">5.36.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.36.0/Module::Load::Conditional">5.36.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.34.3/Module::Load::Conditional">5.34.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.34.2/Module::Load::Conditional">5.34.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.34.1/Module::Load::Conditional">5.34.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.34.0/Module::Load::Conditional">5.34.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.32.1/Module::Load::Conditional">5.32.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.32.0/Module::Load::Conditional">5.32.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.30.3/Module::Load::Conditional">5.30.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.30.2/Module::Load::Conditional">5.30.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.30.1/Module::Load::Conditional">5.30.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.30.0/Module::Load::Conditional">5.30.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.28.3/Module::Load::Conditional">5.28.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.28.2/Module::Load::Conditional">5.28.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.28.1/Module::Load::Conditional">5.28.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.28.0/Module::Load::Conditional">5.28.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.26.3/Module::Load::Conditional">5.26.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.26.2/Module::Load::Conditional">5.26.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.26.1/Module::Load::Conditional">5.26.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.26.0/Module::Load::Conditional">5.26.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.24.4/Module::Load::Conditional">5.24.4</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.24.3/Module::Load::Conditional">5.24.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.24.2/Module::Load::Conditional">5.24.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.24.1/Module::Load::Conditional">5.24.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.24.0/Module::Load::Conditional">5.24.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.22.4/Module::Load::Conditional">5.22.4</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.22.3/Module::Load::Conditional">5.22.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.22.2/Module::Load::Conditional">5.22.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.22.1/Module::Load::Conditional">5.22.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.22.0/Module::Load::Conditional">5.22.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.20.3/Module::Load::Conditional">5.20.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.20.2/Module::Load::Conditional">5.20.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.20.1/Module::Load::Conditional">5.20.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.20.0/Module::Load::Conditional">5.20.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.18.4/Module::Load::Conditional">5.18.4</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.18.3/Module::Load::Conditional">5.18.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.18.2/Module::Load::Conditional">5.18.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.18.1/Module::Load::Conditional">5.18.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.18.0/Module::Load::Conditional">5.18.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.16.3/Module::Load::Conditional">5.16.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.16.2/Module::Load::Conditional">5.16.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.16.1/Module::Load::Conditional">5.16.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.16.0/Module::Load::Conditional">5.16.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.14.4/Module::Load::Conditional">5.14.4</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.14.3/Module::Load::Conditional">5.14.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.14.2/Module::Load::Conditional">5.14.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.14.1/Module::Load::Conditional">5.14.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.14.0/Module::Load::Conditional">5.14.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.12.5/Module::Load::Conditional">5.12.5</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.12.4/Module::Load::Conditional">5.12.4</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.12.3/Module::Load::Conditional">5.12.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.12.2/Module::Load::Conditional">5.12.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.12.1/Module::Load::Conditional">5.12.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.12.0/Module::Load::Conditional">5.12.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.10.1/Module::Load::Conditional">5.10.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.10.0/Module::Load::Conditional">5.10.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.8.9/Module::Load::Conditional">5.8.9</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.8.8/Module::Load::Conditional">5.8.8</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.8.7/Module::Load::Conditional">5.8.7</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.8.6/Module::Load::Conditional">5.8.6</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.8.5/Module::Load::Conditional">5.8.5</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.8.4/Module::Load::Conditional">5.8.4</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.8.3/Module::Load::Conditional">5.8.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.8.2/Module::Load::Conditional">5.8.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.8.1/Module::Load::Conditional">5.8.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.8.0/Module::Load::Conditional">5.8.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.6.2/Module::Load::Conditional">5.6.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.6.1/Module::Load::Conditional">5.6.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.6.0/Module::Load::Conditional">5.6.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.005_04/Module::Load::Conditional">5.005_04</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.005_03/Module::Load::Conditional">5.005_03</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.005_02/Module::Load::Conditional">5.005_02</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.005_01/Module::Load::Conditional">5.005_01</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.005/Module::Load::Conditional">5.005</a>
        </div>
      </li>
      <li class="nav-item dropdown text-nowrap">
        <a class="nav-link dropdown-toggle" href="./Module::Load::Conditional.html#" id="dropdownlink-dev" role="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">Dev</a>
        <div class="dropdown-menu" aria-labelledby="dropdownlink-dev">
          <a class="dropdown-item" href="https://perldoc.perl.org/blead/Module::Load::Conditional">blead</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.39.6/Module::Load::Conditional">5.39.6</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.39.5/Module::Load::Conditional">5.39.5</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.39.4/Module::Load::Conditional">5.39.4</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.39.3/Module::Load::Conditional">5.39.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.39.2/Module::Load::Conditional">5.39.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.39.1/Module::Load::Conditional">5.39.1</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.38.0-RC2/Module::Load::Conditional">5.38.0-RC2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.38.0-RC1/Module::Load::Conditional">5.38.0-RC1</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.37.11/Module::Load::Conditional">5.37.11</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.37.10/Module::Load::Conditional">5.37.10</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.37.9/Module::Load::Conditional">5.37.9</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.37.8/Module::Load::Conditional">5.37.8</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.37.7/Module::Load::Conditional">5.37.7</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.37.6/Module::Load::Conditional">5.37.6</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.37.5/Module::Load::Conditional">5.37.5</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.37.4/Module::Load::Conditional">5.37.4</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.37.3/Module::Load::Conditional">5.37.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.37.2/Module::Load::Conditional">5.37.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.37.1/Module::Load::Conditional">5.37.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.37.0/Module::Load::Conditional">5.37.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.35.11/Module::Load::Conditional">5.35.11</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.35.10/Module::Load::Conditional">5.35.10</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.35.9/Module::Load::Conditional">5.35.9</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.35.8/Module::Load::Conditional">5.35.8</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.35.7/Module::Load::Conditional">5.35.7</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.35.6/Module::Load::Conditional">5.35.6</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.35.5/Module::Load::Conditional">5.35.5</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.35.4/Module::Load::Conditional">5.35.4</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.35.3/Module::Load::Conditional">5.35.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.35.2/Module::Load::Conditional">5.35.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.35.1/Module::Load::Conditional">5.35.1</a>
          <a class="dropdown-item active" href="./Module::Load::Conditional.html">5.35.0</a>
        </div>
      </li>
      <li class="nav-item dropdown text-nowrap">
        <a class="nav-link dropdown-toggle" href="./Module::Load::Conditional.html#" id="dropdownlink-nav" role="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">Documentation</a>
        <div class="dropdown-menu" aria-labelledby="dropdownlink-nav">
          <a class="dropdown-item" href="perl.html">Perl</a>
          <a class="dropdown-item" href="perlintro.html">Intro</a>
          <a class="dropdown-item" href="perl.html#Tutorials">Tutorials</a>
          <a class="dropdown-item" href="perlfaq.html">FAQs</a>
          <a class="dropdown-item" href="perl.html#Reference-Manual">Reference</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="perlop.html">Operators</a>
          <a class="dropdown-item" href="functions.html">Functions</a>
          <a class="dropdown-item" href="variables.html">Variables</a>
          <a class="dropdown-item" href="modules.html">Modules</a>
          <a class="dropdown-item" href="perlutil.html">Utilities</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="perlcommunity.html">Community</a>
          <a class="dropdown-item" href="perlhist.html">History</a>
        </div>
      </li>
    </ul>
    <ul class="navbar-nav">
      <script>
        function set_expand (expand) {
          var perldocdiv = document.getElementById('perldocdiv');
          var width = window.getComputedStyle(perldocdiv).getPropertyValue('max-width');
          var expanded = (width == '' || width == 'none') ? true : false;
          if (expand === null) {
            expand = !expanded;
          }
          if ((expand && !expanded) || (!expand && expanded)) {
            perldocdiv.style.setProperty('max-width', expand ? 'none' : '960px');
            var button_classlist = document.getElementById('content-expand-button').classList;
            if (expand) {
              button_classlist.add('btn-light');
              button_classlist.remove('btn-outline-light');
            } else {
              button_classlist.add('btn-outline-light');
              button_classlist.remove('btn-light');
            }
          }
          return expand;
        }
        function toggle_expand () {
          var expand = set_expand(null);
          document.cookie = 'perldoc_expand=' + (expand ? 1 : 0) + '; path=/; expires=Tue, 19 Jan 2038 03:14:07 UTC';
        }
        function read_expand () {
          return document.cookie.split(';').some(function (item) { return item.indexOf('perldoc_expand=1') >= 0 });
        }
        if (document.readyState === 'loading') {
          document.addEventListener('DOMContentLoaded', function () {
            if (read_expand()) {
              set_expand(true);
            }
          });
        } else if (read_expand()) {
          set_expand(true);
        }
      </script>
      <button id="content-expand-button" type="button" class="btn btn-outline-light d-none d-lg-inline-block mr-2" onclick="toggle_expand()">Expand</button>
    <ul>
    <form class="form-inline" method="get" action="https://perldoc.perl.org/5.35.0/search">
      <input class="form-control mr-3" type="search" name="q" placeholder="Search" aria-label="Search">
    </form>
  </div>
</nav>

    <div id="wrapperlicious" class="container-fluid">
      <div id="perldocdiv">
        <div id="links">
          <a href="./Module::Load::Conditional.html">Module::Load::Conditional</a>
          <div id="more">
            (<a href="./Module::Load::Conditional.txt">source</a>,
            <a href="https://metacpan.org/pod/Module::Load::Conditional">CPAN</a>)
          </div>
            <div id="moduleversion">version 0.74</div>
        </div>
        <div class="leading-notice">
          You are viewing the version of this documentation from Perl 5.35.0.
            This is a development version of Perl.
        </div>
        <h1><a id="toc">CONTENTS</a></h1>
                  <ul>
              <li>
                <a class="text-decoration-none" href="./Module::Load::Conditional.html#NAME">NAME</a>
              </li>
              <li>
                <a class="text-decoration-none" href="./Module::Load::Conditional.html#SYNOPSIS">SYNOPSIS</a>
              </li>
              <li>
                <a class="text-decoration-none" href="./Module::Load::Conditional.html#DESCRIPTION">DESCRIPTION</a>
              </li>
              <li>
                <a class="text-decoration-none" href="./Module::Load::Conditional.html#Methods">Methods</a>
                            <ul>
              <li>
                <a class="text-decoration-none" href="./Module::Load::Conditional.html#$href-=-check_install(-module-=%3E-NAME-%5B,-version-=%3E-VERSION,-verbose-=%3E-BOOL-%5D-);">$href = check_install( module =&gt; NAME [, version =&gt; VERSION, verbose =&gt; BOOL ] );</a>
              </li>
              <li>
                <a class="text-decoration-none" href="./Module::Load::Conditional.html#$bool-=-can_load(-modules-=%3E-%7B-NAME-=%3E-VERSION-%5B,NAME-=%3E-VERSION%5D-%7D,-%5Bverbose-=%3E-BOOL,-nocache-=%3E-BOOL,-autoload-=%3E-BOOL%5D-)">$bool = can_load( modules =&gt; { NAME =&gt; VERSION [,NAME =&gt; VERSION] }, [verbose =&gt; BOOL, nocache =&gt; BOOL, autoload =&gt; BOOL] )</a>
              </li>
              <li>
                <a class="text-decoration-none" href="./Module::Load::Conditional.html#@list-=-requires(-MODULE-);">@list = requires( MODULE );</a>
              </li>
          </ul>

              </li>
              <li>
                <a class="text-decoration-none" href="./Module::Load::Conditional.html#Global-Variables">Global Variables</a>
                            <ul>
              <li>
                <a class="text-decoration-none" href="./Module::Load::Conditional.html#$Module::Load::Conditional::VERBOSE">$Module::Load::Conditional::VERBOSE</a>
              </li>
              <li>
                <a class="text-decoration-none" href="./Module::Load::Conditional.html#$Module::Load::Conditional::FIND_VERSION">$Module::Load::Conditional::FIND_VERSION</a>
              </li>
              <li>
                <a class="text-decoration-none" href="./Module::Load::Conditional.html#$Module::Load::Conditional::CHECK_INC_HASH">$Module::Load::Conditional::CHECK_INC_HASH</a>
              </li>
              <li>
                <a class="text-decoration-none" href="./Module::Load::Conditional.html#$Module::Load::Conditional::FORCE_SAFE_INC">$Module::Load::Conditional::FORCE_SAFE_INC</a>
              </li>
              <li>
                <a class="text-decoration-none" href="./Module::Load::Conditional.html#$Module::Load::Conditional::CACHE">$Module::Load::Conditional::CACHE</a>
              </li>
              <li>
                <a class="text-decoration-none" href="./Module::Load::Conditional.html#$Module::Load::Conditional::ERROR">$Module::Load::Conditional::ERROR</a>
              </li>
              <li>
                <a class="text-decoration-none" href="./Module::Load::Conditional.html#$Module::Load::Conditional::DEPRECATED">$Module::Load::Conditional::DEPRECATED</a>
              </li>
          </ul>

              </li>
              <li>
                <a class="text-decoration-none" href="./Module::Load::Conditional.html#See-Also">See Also</a>
              </li>
              <li>
                <a class="text-decoration-none" href="./Module::Load::Conditional.html#BUG-REPORTS">BUG REPORTS</a>
              </li>
              <li>
                <a class="text-decoration-none" href="./Module::Load::Conditional.html#AUTHOR">AUTHOR</a>
              </li>
              <li>
                <a class="text-decoration-none" href="./Module::Load::Conditional.html#COPYRIGHT">COPYRIGHT</a>
              </li>
          </ul>

      <h1 id="NAME"><a class="permalink" href="./Module::Load::Conditional.html#NAME">#</a>NAME</h1>

<p>Module::Load::Conditional - Looking up module information / loading at runtime</p>

<h1 id="SYNOPSIS"><a class="permalink" href="./Module::Load::Conditional.html#SYNOPSIS">#</a>SYNOPSIS</h1>

<pre><code>use Module::Load::Conditional qw[can_load check_install requires];


my $use_list = {
        CPANPLUS        =&gt; 0.05,
        LWP             =&gt; 5.60,
        &#39;Test::More&#39;    =&gt; undef,
};

print can_load( modules =&gt; $use_list )
        ? &#39;all modules loaded successfully&#39;
        : &#39;failed to load required modules&#39;;


my $rv = check_install( module =&gt; &#39;LWP&#39;, version =&gt; 5.60 )
            or print &#39;LWP is not installed!&#39;;

print &#39;LWP up to date&#39; if $rv-&gt;{uptodate};
print &quot;LWP version is $rv-&gt;{version}\n&quot;;
print &quot;LWP is installed as file $rv-&gt;{file}\n&quot;;


print &quot;LWP requires the following modules to be installed:\n&quot;;
print join &quot;\n&quot;, requires(&#39;LWP&#39;);

### allow M::L::C to peek in your %INC rather than just
### scanning @INC
$Module::Load::Conditional::CHECK_INC_HASH = 1;

### reset the &#39;can_load&#39; cache
undef $Module::Load::Conditional::CACHE;

### don&#39;t have Module::Load::Conditional issue warnings --
### default is &#39;1&#39;
$Module::Load::Conditional::VERBOSE = 0;

### The last error that happened during a call to &#39;can_load&#39;
my $err = $Module::Load::Conditional::ERROR;</code></pre>

<h1 id="DESCRIPTION"><a class="permalink" href="./Module::Load::Conditional.html#DESCRIPTION">#</a>DESCRIPTION</h1>

<p>Module::Load::Conditional provides simple ways to query and possibly load any of the modules you have installed on your system during runtime.</p>

<p>It is able to load multiple modules at once or none at all if one of them was not able to load. It also takes care of any error checking and so forth.</p>

<h1 id="Methods"><a class="permalink" href="./Module::Load::Conditional.html#Methods">#</a>Methods</h1>

<h2 id="$href-=-check_install(-module-=&gt;-NAME-[,-version-=&gt;-VERSION,-verbose-=&gt;-BOOL-]-);"><a class="permalink" href="./Module::Load::Conditional.html#$href-=-check_install(-module-=%3E-NAME-%5B,-version-=%3E-VERSION,-verbose-=%3E-BOOL-%5D-);">#</a><a id="href-check_install-module-NAME-version-VERSION-verbose-BOOL"></a>$href = check_install( module =&gt; NAME [, version =&gt; VERSION, verbose =&gt; BOOL ] );</h2>

<p><code>check_install</code> allows you to verify if a certain module is installed or not. You may call it with the following arguments:</p>

<dl>

<dt id="module"><a class="permalink" href="./Module::Load::Conditional.html#module">#</a>module</dt>
<dd>

<p>The name of the module you wish to verify -- this is a required key</p>

</dd>
<dt id="version"><a class="permalink" href="./Module::Load::Conditional.html#version">#</a>version</dt>
<dd>

<p>The version this module needs to be -- this is optional</p>

</dd>
<dt id="verbose"><a class="permalink" href="./Module::Load::Conditional.html#verbose">#</a>verbose</dt>
<dd>

<p>Whether or not to be verbose about what it is doing -- it will default to $Module::Load::Conditional::VERBOSE</p>

</dd>
</dl>

<p>It will return undef if it was not able to find where the module was installed, or a hash reference with the following keys if it was able to find the file:</p>

<dl>

<dt id="file"><a class="permalink" href="./Module::Load::Conditional.html#file">#</a>file</dt>
<dd>

<p>Full path to the file that contains the module</p>

</dd>
<dt id="dir"><a class="permalink" href="./Module::Load::Conditional.html#dir">#</a>dir</dt>
<dd>

<p>Directory, or more exact the <code>@INC</code> entry, where the module was loaded from.</p>

</dd>
<dt id="version1"><a class="permalink" href="./Module::Load::Conditional.html#version1">#</a>version</dt>
<dd>

<p>The version number of the installed module - this will be <code>undef</code> if the module had no (or unparsable) version number, or if the variable <code>$Module::Load::Conditional::FIND_VERSION</code> was set to true. (See the <code>GLOBAL VARIABLES</code> section below for details)</p>

</dd>
<dt id="uptodate"><a class="permalink" href="./Module::Load::Conditional.html#uptodate">#</a>uptodate</dt>
<dd>

<p>A boolean value indicating whether or not the module was found to be at least the version you specified. If you did not specify a version, uptodate will always be true if the module was found. If no parsable version was found in the module, uptodate will also be true, since <code>check_install</code> had no way to verify clearly.</p>

<p>See also <code>$Module::Load::Conditional::DEPRECATED</code>, which affects the outcome of this value.</p>

</dd>
</dl>

<h2 id="$bool-=-can_load(-modules-=&gt;-{-NAME-=&gt;-VERSION-[,NAME-=&gt;-VERSION]-},-[verbose-=&gt;-BOOL,-nocache-=&gt;-BOOL,-autoload-=&gt;-BOOL]-)"><a class="permalink" href="./Module::Load::Conditional.html#$bool-=-can_load(-modules-=%3E-%7B-NAME-=%3E-VERSION-%5B,NAME-=%3E-VERSION%5D-%7D,-%5Bverbose-=%3E-BOOL,-nocache-=%3E-BOOL,-autoload-=%3E-BOOL%5D-)">#</a><a id="bool-can_load-modules-NAME-VERSION-NAME-VERSION-verbose-BOOL-nocache-BOOL-autoload-BOOL"></a>$bool = can_load( modules =&gt; { NAME =&gt; VERSION [,NAME =&gt; VERSION] }, [verbose =&gt; BOOL, nocache =&gt; BOOL, autoload =&gt; BOOL] )</h2>

<p><code>can_load</code> will take a list of modules, optionally with version numbers and determine if it is able to load them. If it can load *ALL* of them, it will. If one or more are unloadable, none will be loaded.</p>

<p>This is particularly useful if you have More Than One Way (tm) to solve a problem in a program, and only wish to continue down a path if all modules could be loaded, and not load them if they couldn&#39;t.</p>

<p>This function uses the <code>load</code> function or the <code>autoload_remote</code> function from Module::Load under the hood.</p>

<p><code>can_load</code> takes the following arguments:</p>

<dl>

<dt id="modules"><a class="permalink" href="./Module::Load::Conditional.html#modules">#</a>modules</dt>
<dd>

<p>This is a hashref of module/version pairs. The version indicates the minimum version to load. If no version is provided, any version is assumed to be good enough.</p>

</dd>
<dt id="verbose1"><a class="permalink" href="./Module::Load::Conditional.html#verbose1">#</a>verbose</dt>
<dd>

<p>This controls whether warnings should be printed if a module failed to load. The default is to use the value of $Module::Load::Conditional::VERBOSE.</p>

</dd>
<dt id="nocache"><a class="permalink" href="./Module::Load::Conditional.html#nocache">#</a>nocache</dt>
<dd>

<p><code>can_load</code> keeps its results in a cache, so it will not load the same module twice, nor will it attempt to load a module that has already failed to load before. By default, <code>can_load</code> will check its cache, but you can override that by setting <code>nocache</code> to true.</p>

</dd>
<dt id="autoload"><a class="permalink" href="./Module::Load::Conditional.html#autoload">#</a>autoload</dt>
<dd>

<p>This controls whether imports the functions of a loaded modules to the caller package. The default is no importing any functions.</p>

<p>See the <code>autoload</code> function and the <code>autoload_remote</code> function from <a href="./Module::Load.html">Module::Load</a> for details.</p>

</dd>
</dl>

<h2 id="@list-=-requires(-MODULE-);"><a class="permalink" href="./Module::Load::Conditional.html#@list-=-requires(-MODULE-);">#</a><a id="list-requires-MODULE"></a>@list = requires( MODULE );</h2>

<p><code>requires</code> can tell you what other modules a particular module requires. This is particularly useful when you&#39;re intending to write a module for public release and are listing its prerequisites.</p>

<p><code>requires</code> takes but one argument: the name of a module. It will then first check if it can actually load this module, and return undef if it can&#39;t. Otherwise, it will return a list of modules and pragmas that would have been loaded on the module&#39;s behalf.</p>

<p>Note: The list <code>require</code> returns has originated from your current perl and your current install.</p>

<h1 id="Global-Variables"><a class="permalink" href="./Module::Load::Conditional.html#Global-Variables">#</a><a id="Global"></a>Global Variables</h1>

<p>The behaviour of Module::Load::Conditional can be altered by changing the following global variables:</p>

<h2 id="$Module::Load::Conditional::VERBOSE"><a class="permalink" href="./Module::Load::Conditional.html#$Module::Load::Conditional::VERBOSE">#</a><a id="Module::Load::Conditional::VERBOSE"></a>$Module::Load::Conditional::VERBOSE</h2>

<p>This controls whether Module::Load::Conditional will issue warnings and explanations as to why certain things may have failed. If you set it to 0, Module::Load::Conditional will not output any warnings. The default is 0;</p>

<h2 id="$Module::Load::Conditional::FIND_VERSION"><a class="permalink" href="./Module::Load::Conditional.html#$Module::Load::Conditional::FIND_VERSION">#</a><a id="Module::Load::Conditional::FIND_VERSION"></a>$Module::Load::Conditional::FIND_VERSION</h2>

<p>This controls whether Module::Load::Conditional will try to parse (and eval) the version from the module you&#39;re trying to load.</p>

<p>If you don&#39;t wish to do this, set this variable to <code>false</code>. Understand then that version comparisons are not possible, and Module::Load::Conditional can not tell you what module version you have installed. This may be desirable from a security or performance point of view. Note that <code>$FIND_VERSION</code> code runs safely under <code>taint mode</code>.</p>

<p>The default is 1;</p>

<h2 id="$Module::Load::Conditional::CHECK_INC_HASH"><a class="permalink" href="./Module::Load::Conditional.html#$Module::Load::Conditional::CHECK_INC_HASH">#</a><a id="Module::Load::Conditional::CHECK_INC_HASH"></a>$Module::Load::Conditional::CHECK_INC_HASH</h2>

<p>This controls whether <code>Module::Load::Conditional</code> checks your <code>%INC</code> hash to see if a module is available. By default, only <code>@INC</code> is scanned to see if a module is physically on your filesystem, or available via an <code>@INC-hook</code>. Setting this variable to <code>true</code> will trust any entries in <code>%INC</code> and return them for you.</p>

<p>The default is 0;</p>

<h2 id="$Module::Load::Conditional::FORCE_SAFE_INC"><a class="permalink" href="./Module::Load::Conditional.html#$Module::Load::Conditional::FORCE_SAFE_INC">#</a><a id="Module::Load::Conditional::FORCE_SAFE_INC"></a>$Module::Load::Conditional::FORCE_SAFE_INC</h2>

<p>This controls whether <code>Module::Load::Conditional</code> sanitises <code>@INC</code> by removing &quot;<code>.</code>&quot;. The current default setting is <code>0</code>, but this may change in a future release.</p>

<h2 id="$Module::Load::Conditional::CACHE"><a class="permalink" href="./Module::Load::Conditional.html#$Module::Load::Conditional::CACHE">#</a><a id="Module::Load::Conditional::CACHE"></a>$Module::Load::Conditional::CACHE</h2>

<p>This holds the cache of the <code>can_load</code> function. If you explicitly want to remove the current cache, you can set this variable to <code>undef</code></p>

<h2 id="$Module::Load::Conditional::ERROR"><a class="permalink" href="./Module::Load::Conditional.html#$Module::Load::Conditional::ERROR">#</a><a id="Module::Load::Conditional::ERROR"></a>$Module::Load::Conditional::ERROR</h2>

<p>This holds a string of the last error that happened during a call to <code>can_load</code>. It is useful to inspect this when <code>can_load</code> returns <code>undef</code>.</p>

<h2 id="$Module::Load::Conditional::DEPRECATED"><a class="permalink" href="./Module::Load::Conditional.html#$Module::Load::Conditional::DEPRECATED">#</a><a id="Module::Load::Conditional::DEPRECATED"></a>$Module::Load::Conditional::DEPRECATED</h2>

<p>This controls whether <code>Module::Load::Conditional</code> checks if a dual-life core module has been deprecated. If this is set to true <code>check_install</code> will return false to <code>uptodate</code>, if a dual-life module is found to be loaded from <code>$Config{privlibexp}</code></p>

<p>The default is 0;</p>

<h1 id="See-Also"><a class="permalink" href="./Module::Load::Conditional.html#See-Also">#</a><a id="See"></a>See Also</h1>

<p><code>Module::Load</code></p>

<h1 id="BUG-REPORTS"><a class="permalink" href="./Module::Load::Conditional.html#BUG-REPORTS">#</a><a id="BUG"></a>BUG REPORTS</h1>

<p>Please report bugs or other issues to &lt;bug-module-load-conditional@rt.cpan.org&gt;.</p>

<h1 id="AUTHOR"><a class="permalink" href="./Module::Load::Conditional.html#AUTHOR">#</a>AUTHOR</h1>

<p>This module by Jos Boumans &lt;kane@cpan.org&gt;.</p>

<h1 id="COPYRIGHT"><a class="permalink" href="./Module::Load::Conditional.html#COPYRIGHT">#</a>COPYRIGHT</h1>

<p>This library is free software; you may redistribute and/or modify it under the same terms as Perl itself.</p>


      </div>
      <div id="footer">
        <p>Perldoc Browser is maintained by Dan Book (<a href="https://metacpan.org/author/DBOOK">DBOOK</a>). Please contact him via the <a href="https://github.com/Grinnz/perldoc-browser/issues">GitHub issue tracker</a> or <a href="mailto:dbook@cpan.org">email</a> regarding any issues with the site itself, search, or rendering of documentation.</p>

<p>The Perl documentation is maintained by the Perl 5 Porters in the development of Perl. Please contact them via the <a href="https://github.com/Perl/perl5/issues">Perl issue tracker</a>, the <a href="https://lists.perl.org/list/perl5-porters.html">mailing list</a>, or <a href="https://kiwiirc.com/client/irc.perl.org/p5p">IRC</a> to report any issues with the contents or format of the documentation.</p>


      </div>
    </div>
    <script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.5.1/jquery.slim.min.js" integrity="sha512-/DXTXr6nQodMUiq+IUJYCt2PPOUjrHJ9wFrqpJ3XkgPNOZVfMok7cRw6CSxyCQxXn6ozlESsSh1/sMCTF1rL/g==" crossorigin="anonymous"></script>
    <script src="https://cdnjs.cloudflare.com/ajax/libs/popper.js/1.16.1/umd/popper.min.js" integrity="sha512-ubuT8Z88WxezgSqf3RLuNi5lmjstiJcyezx34yIU2gAHonIi27Na7atqzUZCOoY4CExaoFumzOsFQ2Ch+I/HCw==" crossorigin="anonymous"></script>
    <script src="https://stackpath.bootstrapcdn.com/bootstrap/4.5.2/js/bootstrap.min.js" integrity="sha384-B4gt1jrGC7Jh4AgTPSdUtOBvfO8shuf57BaghqFfPlYxofvL8/KUEfYiJOMMV+rV" crossorigin="anonymous"></script>
    <script src="../highlight.pack.js"></script>
    <script>hljs.highlightAll();</script>
  </body>
</html>
